<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Internals - Reserved special namespace for internals related functions - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/Internals">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="Internals.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/Internals">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/Internals">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/Internals">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/Internals">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/Internals">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/Internals">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/Internals">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/Internals">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/Internals">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/Internals">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/Internals">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/Internals">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/Internals">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/Internals">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/Internals">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/Internals">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/Internals">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/Internals">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/Internals">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/Internals">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/Internals">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/Internals">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/Internals">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/Internals">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/Internals">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/Internals">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/Internals">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/Internals">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/Internals">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/Internals">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/Internals">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/Internals">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/Internals">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/Internals">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/Internals">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/Internals">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/Internals">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/Internals">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/Internals">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/Internals">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/Internals">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/Internals">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/Internals">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/Internals">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/Internals">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/Internals">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/Internals">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/Internals">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/Internals">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/Internals">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/Internals">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/Internals">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/Internals">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/Internals">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/Internals">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/Internals">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/Internals">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/Internals">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/Internals">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/Internals">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/Internals">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/Internals">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/Internals">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/Internals">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/Internals">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/Internals">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/Internals">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/Internals">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/Internals">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/Internals">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/Internals">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/Internals">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/Internals">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/Internals">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/Internals">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/Internals">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/Internals">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/Internals">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/Internals">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/Internals">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="Internals.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/Internals">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/Internals">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/Internals">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/Internals">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/Internals">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/Internals">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/Internals">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/Internals">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/Internals">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/Internals">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/Internals">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/Internals">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/Internals">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/Internals">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/Internals">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/Internals">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/Internals">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/Internals">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/Internals">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/Internals">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/Internals">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/Internals">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/Internals">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/Internals">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/Internals">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/Internals">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/Internals">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/Internals">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/Internals">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/Internals">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/Internals">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/Internals">5.35.1</a>
          <a class="dropdown-item active" href="Internals.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="Internals.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="Internals.html">Internals</a>
          <div id="more">
            (<a href="Internals.txt">source</a>,
            <a href="https://metacpan.org/pod/Internals">CPAN</a>)
          </div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="Internals.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="Internals.html#SYNOPSIS">SYNOPSIS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="Internals.html#DESCRIPTION">DESCRIPTION</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="Internals.html#FUNCTIONS">FUNCTIONS</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="Internals.html#AUTHOR">AUTHOR</a>
              </li>
              <li>
                <a class="text-decoration-none" href="Internals.html#SEE-ALSO">SEE ALSO</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="Internals.html#NAME">#</a>NAME</h1>

<p>Internals - Reserved special namespace for internals related functions</p>

<h1 id="SYNOPSIS"><a class="permalink" href="Internals.html#SYNOPSIS">#</a>SYNOPSIS</h1>

<pre><code>$is_ro= Internals::SvREADONLY($x)
$refcnt= Internals::SvREFCNT($x)
hv_clear_placeholders(%hash);</code></pre>

<h1 id="DESCRIPTION"><a class="permalink" href="Internals.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>The Internals namespace is used by the core Perl development team to expose certain low level internals routines for testing and other purposes.</p>

<p>In theory these routines were not and are not intended to be used outside of the perl core, and are subject to change and removal at any time.</p>

<p>In practice people have come to depend on these over the years, despite being historically undocumented, so we will provide some level of forward compatibility for some time. Nevertheless you can assume that any routine documented here is experimental or deprecated and you should find alternatives to their use.</p>

<h2 id="FUNCTIONS"><a class="permalink" href="Internals.html#FUNCTIONS">#</a>FUNCTIONS</h2>

<dl>

<dt id="SvREFCNT(THING-[,-$value])"><a class="permalink" href="Internals.html#SvREFCNT(THING-%5B,-$value%5D)">#</a><a id="SvREFCNT"></a><a id="SvREFCNT-THING-value"></a>SvREFCNT(THING [, $value])</dt>
<dd>

<p>Historically Perl has been a refcounted language. This means that each variable tracks how many things reference it, and when the variable is no longer referenced it will automatically free itself. In theory Perl code should not have to care about this, and in a future version Perl might change to some other strategy, although in practice this is unlikely.</p>

<p>This function allows one to violate the abstraction of variables and get or set the refcount of a variable, and in generally is really only useful in code that is testing refcount behavior.</p>

<p>*NOTE* You are strongly discouraged from using this function in non-test code and especially discouraged from using the set form of this function. The results of doing so may result in segmentation faults or other undefined behavior.</p>

</dd>
<dt id="SvREADONLY(THING,-[,-$value])"><a class="permalink" href="Internals.html#SvREADONLY(THING,-%5B,-$value%5D)">#</a><a id="SvREADONLY"></a><a id="SvREADONLY-THING-value"></a>SvREADONLY(THING, [, $value])</dt>
<dd>

<p>Set or get whether a variable is readonly or not. Exactly what the readonly flag means depend on the type of the variable affected and the version of perl used.</p>

<p>You are strongly discouraged from using this function directly. It is used by various core modules, like <code>Hash::Util</code>, and the <code>constant</code> pragma to implement higher-level behavior which should be used instead.</p>

<p>See the core implementation for the exact meaning of the readonly flag for each internal variable type.</p>

</dd>
<dt id="hv_clear_placeholders(%hash)"><a class="permalink" href="Internals.html#hv_clear_placeholders(%25hash)">#</a><a id="hv_clear_placeholders"></a><a id="hv_clear_placeholders-hash"></a>hv_clear_placeholders(%hash)</dt>
<dd>

<p>Clear any placeholders from a locked hash. Should not be used directly. You should use the wrapper functions provided by Hash::Util instead. As of 5.25 also available as <code> Hash::Util::_clear_placeholders(%hash) </code></p>

</dd>
</dl>

<h1 id="AUTHOR"><a class="permalink" href="Internals.html#AUTHOR">#</a>AUTHOR</h1>

<p>Perl core development team.</p>

<h1 id="SEE-ALSO"><a class="permalink" href="Internals.html#SEE-ALSO">#</a><a id="SEE"></a>SEE ALSO</h1>

<p><a href="perlguts.html">perlguts</a> <a href="./Hash::Util.html">Hash::Util</a> <a href="constant.html">constant</a> universal.c</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
